<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>FAQ KM_importador</title>
<style type="text/css">
<!--
.style1 {
	color: #FF0000
}
-->
</style>
</head>

<body>
<h1>FAQ KM_importador</h1>
<h2>Especificações gerais</h2>
Cada linha do arquivo de layout é responsável por definir um campo, o sinal de igualdade separam os
vários item da definição sendo os conjuntos separados assim:
<br />
Ex:
<table border="1">
	<tr>
		<th>Tipo</th>
		<th>Separador</th>
		<th>Nome do campo(1)</th>
		<th>Separador</th>
		<th>Tamanho(2)</th>
		<th>Comentários(3)</th>
	</tr>
	<tr>
		<td>N</td>
		<td align="center">=</td>
		<td>IDCLIENTE</td>
		<td align="center">=</td>
		<td>10</td>
		<td>//Código cliente</td>
	</tr>
	<tr>
		<td>S</td>
		<td align="center">=</td>
		<td>NMCLIENTE</td>
		<td align="center">=</td>
		<td>60</td>
		<td>//Nome cliente</td>
	</tr>
	<tr>
		<td>N,2</td>
		<td align="center">=</td>
		<td>VALOR_COMPRA</td>
		<td align="center">=</td>
		<td>10</td>
		<td>//Valor compado</td>
	</tr>
	<tr>
		<td>D,%Y-%m-%d</td>
		<td align="center">=</td>
		<td>DATA_COMPRA</td>
		<td align="center">=</td>
		<td>6</td>
		<td>//Data da compra</td>
	</tr>
</table>

<ol>
	<li>Sempre maiúsculo, sem caracteres especiais ou espaço</li>
	<li>Necessário quanto do tipo do arquivo é de campos com tamanho especifico</li>
	<li>Campo não obrigatório, inicia-se com //(dupla barra) e vai ate o final da linha</li>
</ol>
<h2>Definição dos tipos</h2>
Na definição de tipo são aceitos parâmetros adicionais após o símbolo do tipo, a quantidade e tipos
destes parâmetros vão depender diretamente das especificações do tipo e devem ser passados
separando-os com virgula
<table border="1">
	<tr>
		<th>Símbolo a ser usado</th>
		<th>Quando utilizar</th>
		<th>Comentário</th>
	</tr>
	<tr>
		<td>S</td>
		<td>Use para textos em geral</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>N</td>
		<td>Use para números inteiros ou decimais</td>
		<td>Na leitura deste campo serão ignorados tudo que não seja números entre 0 e 9 e o sinal de
		“-“(negativo), portanto mesmo que venha a separação decimal do Excel esta será ignorada e
		prevalecerá a especificada no layout
		<ul>
			<li>O primeiro parâmetro que este tipo aceita é a quantidade de casas decimais para a
			leitura. <br> Ex: 
			<table border="1">
				<tr>
					<th nowrap="nowrap">Definição<br>N [, Número de casas decimais ]</th>
					<th nowrap="nowrap">Valor no Arquivo</th>
					<th nowrap="nowrap">Valor Devolvido</th>
				</tr>
				<tr>
					<td>N,2</td>
					<td>0001000</td>
					<td>10.00</td>
				</tr>
				<tr>
					<td>N,0 ou N</td>
					<td>R$ 1.500</td>
					<td>1500</td>
				</tr>
				<tr>
					<td>N,2</td>
					<td>00-1000</td>
					<td>-10.00</td>
				</tr>
				<tr>
					<td>N,2</td>
					<td>R$ -1.500,59</td>
					<td>-1500.59</td>
				</tr>
			</table>
			</li>
		</ul>
		</td>
	</tr>
	<tr>
		<td>D</td>
		<td>Use para valores do tipo data e/ou hora</td>
		<td>Este tipo aceita dois parametros adicionais:
		<ul>
			<li><i>(Obrigatório)</i> Define o formato da data no arquivo. O valor deste parametro deve
			estar no mesmo formato de <a href="http://br.php.net/strftime">strftime</a></li>
			<li><i>(Opcional)</i> Define o formato que será devolvido. O valor deste parametro deve
			estar no mesmo formato de <a href="http://br.php.net/strftime">strftime</a>, se não for
			especificado nenhum devolverá no formato <a href="http://br.php.net/time">Unix Timestamp</a></li>
		</ul>

		<table border="1">
			<tr>
				<th nowrap="nowrap">Definição<br>D, [ Formato arquivo ][, Formato devolução ]</th>
				<th nowrap="nowrap">Valor no Arquivo</th>
				<th nowrap="nowrap">Valor Devolvido</th>
			</tr>
			<tr>
				<td>D,%d%m%y</td>
				<td>260209</td>
				<td>1235617200</td>
			</tr>
			<tr>
				<td>D,%Y-%m-%d,%d/%m/%Y</td>
				<td>2009-02-26</td>
				<td>26/02/2009</td>
			</tr>
			<tr>
				<td>D,%d%m%y,%d/%m/%Y</td>
				<td>260209</td>
				<td>26/02/2009</td>
			</tr>
		</table>
		</td>
	</tr>
</table>
&nbsp;
</body>
</html>

